home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / langs / cc68x.zoo / cc68x.1 next >
Encoding:
Text File  |  1994-12-04  |  3.3 KB  |  133 lines
  1. CC68X(1)          USER COMMANDS              CC68X(1)
  2.  
  3.  
  4. NAME
  5.  
  6.     cc68x - a simple c68 compiler driver
  7.  
  8. SYNOPSIS
  9.  
  10.     cc68x [options] file [file ..]
  11.  
  12. DESCRIPTION
  13.  
  14.     >>> This document isn't finished yet <<<
  15.  
  16. OPTIONS
  17.  
  18.     -c        Compile, but don't link.
  19.  
  20.     -D<name[=val]>    Define preprocessor symbol <name>.
  21.  
  22.     -E        Preprocess to stdout.
  23.  
  24.     -f        Link with libm.a and  make sure that the floating
  25.             point versions of printf and scanf are being used.
  26.  
  27.     -g        Compile for use with debugger.
  28.  
  29.     -I<path>    Add <path> to header file search list.
  30.  
  31.     -l<name>    Link with the library <name>.  See below for
  32.             naming conventions.
  33.  
  34.     -n        Like -v, but don't really do anything.
  35.  
  36.     -N<X>=<prog>    The program <prog> will be executed to perform
  37.             the specified compilation phase instead of the
  38.             default program.  <X> can be one of:
  39.  
  40.                 P -- preprocessing phase
  41.                 C -- code generation phase
  42.                 A -- assembly phase
  43.                 L -- linking phase
  44.  
  45.     -o <file>    Name the output file.
  46.  
  47.     -O        Enable full optimization.
  48.  
  49.     -p        Compile with profiling code.  This option is not
  50.             yet supported.
  51.  
  52.     -P        Preprocess, but don't compile.
  53.  
  54.     -S        Compile, but don't assemble.
  55.  
  56.     -t        Don't remove temporary files.
  57.  
  58.     -U<name>    Undefine preprocessor symbol <name>.
  59.  
  60.     -v        Verbose mode, cc68x shows what it's doing  (-v -v
  61.             will show additional version information about
  62.             the various passes).
  63.  
  64.     -W<n>        Set c68's warning level to <n>.  Legal values
  65.             range from 0 to 6, with higher values giving
  66.             pickier warnings.  -W3 is the default.
  67.  
  68.     -ansi        Set c68 and cpp for ANSI or K&R mode, respectively.
  69.     -trad        Default is -ansi.
  70.  
  71.     -mshort        Selects integer size.  -mshort is the default, and
  72.     -mlong        sets sizeof(int) == 2; -mlong sets sizeof(int) == 4.
  73.             Note that when -mlong is in effect, the names of the
  74.             system libraries and libraries include with -l are
  75.             suffixed with '32' (ie. `-lfred' ==> libfred32.a).
  76.  
  77.     +<X><opt>    The option <opt> is passed directly to the
  78.             compilation phase specified by <X>.  <X> can be one
  79.             of:
  80.  
  81.                 P -- preprocessing phase
  82.                 C -- code generation phase
  83.                 A -- assembly phase
  84.                 L -- linking phase
  85.  
  86. LIBRARIES
  87.  
  88.     cc68x recognizes two library naming schemes:  Unix-style and
  89.     TOS-style.  When the option `-lfred' is given, cc68x searches
  90.     the directories listed in the environment variable $C68LIB for
  91.     the Unix-style translation of the option, and then searches them
  92.     for the TOS-style translation.  The exact translation depends on
  93.     the presence of the -mshort or -mlong option:
  94.  
  95.             Unix style    TOS style
  96.  
  97.     with -mshort    libfred.a    fred.lib
  98.     with -mlong    libfred32.a    fred.l32
  99.  
  100.     Note that the Unix-style name can exceed the filename length
  101.     restrictions of the TOS file system, especially with -mlong;
  102.     if you are using a non-MiNT-aware linker, you may want to
  103.     use TOS-style library names to avoid filename collision.
  104.  
  105. FILES
  106.  
  107.     cc68x recognizes the following file name extensions:
  108.  
  109.     .c    C source
  110.  
  111.     .cpp    Assembler source with preprocessor directives
  112.     .spp
  113.  
  114.     .i    Preprocessed C source
  115.  
  116.     .s    Assembler source
  117.  
  118.     All other files are treated as object files or libraries
  119.     and passed to the linker.
  120.  
  121. ENVIRONMENT
  122.  
  123.     $C68INC        list of search paths for header files
  124.     $C68LIB        path for standard library (no list!)
  125.  
  126. AUTHOR
  127.  
  128.     dsb@cs.duke.edu (Scott Bigham)
  129.  
  130. SEE ALSO
  131.  
  132.     make(1), cpp(1), c68(1), as68(1), ld(1).
  133.